home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_1 / cdsub40.zip / CDSUB.DOC < prev    next >
Text File  |  1992-06-08  |  13KB  |  281 lines
  1.  
  2.                                   CD SUB 4.0
  3.                                   ==========
  4.  
  5.          One of The Livewire BBS PCBoard(TM) multi-BBS Doorware programs.
  6.                  Supporting PCBoard, Wildcat!, Gap, QBBS, RBBS,
  7.                  Remote Access, SpitFire, Ultra, WWIV and more
  8.  
  9.                                   Written By
  10.  
  11.                                 Richard Paquette
  12.                                    PO Box 416
  13.                               Mt. Laurel, NJ 08054
  14.                                (C) Copyright 1991
  15.                                All Rights Reserved
  16.  
  17.                  DOOR DESCRIPTION!
  18.  
  19.  CD Sub is a very simple door... it allows players to guess two numbers, we
  20.  randomly spin for two numbers, if they match the players guessed numbers,
  21.  then the player wins a SIX MONTH (6 issues) subscription FREE to the only
  22.  BBS Magazine available for Callers... The BBS Callers Digest.
  23.  
  24.  If the player doesn't match the two numbers, then he/she is asked if they
  25.  would like to subscribe to the magazine using their Visa/MasterCard. 
  26.  
  27.  Please upload your ORDER.DAT file as often as there are entries.. so that
  28.  we can process the orders.. when you register this door.. you get a free
  29.  listing in the authorized CDSUB BBS List which will appear in the print
  30.  BBS Callers Digest each month along with the electronic version.
  31.  
  32.  Please name the zip file with order.dat according to your registration
  33.  number.. for example if your reg number is 123456, then please name the
  34.  zip 123456.zip... "pkzip 123456 order.dat" would be the command to use.
  35.  
  36.  When you upload the 123456.ZIP file to The Livewire BBS, please mark the
  37.  file PRIVATE with a forward slash / in front of the description. 
  38.  
  39.  If the player decides to download the order form to send in with his
  40.  check or money order.. he MUST include the name of the BBS he/she got
  41.  the order form from in order for us to remit your commissions to you.
  42.  
  43.  If you have already registered a door program from "Livewire Doors" then
  44.  you have access already to all node numbers, if not then you can call
  45.  609-235-5297 to register CD Sub... because if the door isn't registered
  46.  NO ORDER.DAT file will be created. Any FREE subscription winners WILL NOT
  47.  be supported...
  48.  
  49.            *** SPECIAL NOTICE TO ALL REGISTERED SYSOPS! ***
  50.  
  51.  When this door is registered, your BBS name and access number will be
  52.  listed in BBS Callers Digest as an authorized BBS to order subscriptions
  53.  online. This "FREE" listing will be appended in each monthly copy of the
  54.  BBS Callers Digest Magazine.
  55.  
  56.                                    FILES
  57.  
  58.                The following files are packaged with CD SUB
  59.  
  60.  cdsub.exe      <--- executable program must be in directory at all times
  61.  cdsub.cfg      <--- sample configuration file, must have one for each node
  62.  cdsub          <--- Sample batch file to call up door program
  63.  cdsub.doc      <--- What you are reading right now (includes order form)
  64.  history.doc    <--- History of door versions
  65.  order.dat      <--- Created if not there.. To be uploaded to us often
  66.  bbscd.log      <--- Created if not there.. shows who downloaded order form
  67.  bbscd.frm      <--- Order form that is downloadable from within the door
  68.                      PLEASE DO NOT delete this file.. the door WILL NOT
  69.                      operate correctly. PLEASE DO NOT EDIT THIS FILE EITHER!
  70.  order.frm      <--- Order form for all Livewire Doors
  71.  
  72.  PLEASE remember to upload us the ORDER.DAT file, it may contain names of any
  73.  winners in the door or credit card subscriptions... we cannot remit to you
  74.  unless we have the order.dat file!
  75.  
  76.  NOTE PLEASE: We have used PKLite on the Executable file and if you have any
  77.               problems, please let us know as soon as possible. Thanks
  78.  
  79.                       Example Configuration for CD Sub
  80.  
  81.         c:\pcb\users.sys         <=- Full name of your systems file (see below)
  82.         The Livewire BBS         <=- Full name of your BBS
  83.         Richard                  <=- Full first name of Sysop
  84.         Paquette                 <=- Full last name of Sysop
  85.         123456                   <=- Your reg number (Something must be here!)
  86.         3                        <=- Number of times caller can use door today
  87.  
  88. IMPORTANT NOTE!! (Please Read Me!)
  89.  
  90.   We have tested the routine that controls how many times the door can be
  91.   used in any 24 hour period, but it will sometimes NOT allow the player 
  92.   in on the next day.. if that should occur... just delete the CDSUB.USR
  93.   file, the program will create a new one.
  94.  
  95.   As a matter of fact, we suggest that you delete the file each night in
  96.   your nightly event with a command similiar to the following:
  97.  
  98.      --> if exist c:\cdsub\cdsub.usr del c:\cdsub\cdsub.usr  <--
  99.  
  100.   You can now take advantage of the PCBoard set variables in Board.bat.. if you
  101.   want to use them.. this door will read them.. 
  102.  
  103.   NOTE:  You must have DSZ in the your path somewhere for callers to be able to
  104.   download the order form.
  105.  
  106. GENERAL CONFIGURATION EXAMPLES
  107.  
  108.         EXAMPLE CONFIGURATION FILE FOR PCBOARD.SYS
  109.         ------------------------------------------
  110.  
  111.         C:\PCB\PCBOARD.SYS  <=-  (Full pathname of your PCBOARD.SYS file)
  112.         The Livewire BBS    <=-  (Change this to your BBS name)
  113.         Richard             <=-  (The Sysop's first name)
  114.         Paquette            <=-  (The Sysop's last name)
  115.  
  116.         EXAMPLE CONFIGURATION FILE FOR USERS.SYS
  117.         ------------------------------------------
  118.  
  119.         C:\PCB\USERS.SYS    <=-  (Full pathname of your USERS.SYS file)
  120.         The Livewire BBS    <=-  (Change this to your BBS name)
  121.         Richard             <=-  (The Sysop's first name)
  122.         Paquette            <=-  (The Sysop's last name)
  123.  
  124.         EXAMPLE CONFIGURATION FILE FOR DOOR.SYS
  125.         ---------------------------------------
  126.  
  127.         C:\BBS\DOOR.SYS     <=-  (Full pathname of your DOOR.SYS file)
  128.         The Livewire BBS    <=-  (Change this to your BBS name)
  129.         Richard             <=-  (The Sysop's first name)
  130.         Paquette            <=-  (The Sysop's last name)
  131.  
  132.         EXAMPLE CONFIGURATION FILE FOR CALLINFO.BBS
  133.         -------------------------------------------
  134.  
  135.         C:\BBS\CALLINFO.BBS <=-  (Full pathname of your CALLINFO.BBS file)
  136.         The Livewire BBS    <=-  (Change this to your BBS name)
  137.         Richard             <=-  (The Sysop's first name)
  138.         Paquette            <=-  (The Sysop's last name)
  139.  
  140.         EXAMPLE CONFIGURATION FILE FOR DORINFOx.DEF
  141.         -------------------------------------------
  142.  
  143.         C:\BBS\DORINFOx.DEF <=-  (Full pathname of your DORINFOx.DEF file
  144.                                   where 'x' is the BBS Node number.
  145.         The Livewire BBS    <=-  (Change this to your BBS name)
  146.         Richard             <=-  (The Sysop's first name)
  147.         Paquette            <=-  (The Sysop's last name)
  148.  
  149.         EXAMPLE CONFIGURATION FILE FOR SFDOORS.DAT
  150.         ------------------------------------------
  151.  
  152.         C:\BBS\SFDOORS.DAT  <=-  (Full pathname of your SFDOORS.DAT file)
  153.         The Livewire BBS    <=-  (Change this to your BBS name)
  154.         Richard             <=-  (The Sysop's first name)
  155.         Paquette            <=-  (The Sysop's last name)
  156.  
  157.         EXAMPLE CONFIGURATION FILE FOR CHAIN.TXT
  158.         ----------------------------------------
  159.  
  160.         C:\BBS\CHAIN.TXT    <=-  (Full pathname of your CHAIN.TXT file)
  161.         The Livewire BBSS   <=-  (Change this to your BBS name)
  162.         Richard             <=-  (The Sysop's first name)
  163.         Paquette            <=-  (The Sysop's last name)
  164.  
  165.                               ==============
  166.  
  167.                             CD Sub BATCH FILE
  168.  
  169. This is the batch file whose name is entered in PCBSETUP. It should reside in
  170. your default PCB directory. Leave this as is except for changing the paths.
  171.  
  172.           ECHO OFF
  173.           C:
  174.           CD\CDSUB
  175.           CDSUB CDSUB.CFG  <--- Please read NOTE below
  176.           C:
  177.           CD\PCB
  178.           IF EXIST EVENT.BAT EVENT          
  179.           BOARD
  180.  
  181.   NOTE: CD Sub requires the presence of BRT71EFR.EXE either in the
  182.         same directory as CD Sub or accessible via PATH. If you set
  183.         your library in autoexec.bat and all the brun files there,
  184.         then you have no problems.. 
  185.  
  186.         SET MYLIB = C:\MYLIB
  187.  
  188.         Be sure to put all your brun*.exe files in the mylib directory!
  189.  
  190.   NOTE: This door is multi-node capable and the requirement is to have a
  191.         different CD Sub.cfg passed on the batch file command line, such as:
  192.             CDSub CDSub1.cfg * CDSub CDSub2.cfg * CDSub CDSub3.cfg!
  193.  
  194.                      ------------------------------------
  195.  
  196.                                 DOOR OPERATION
  197.                                 --------------
  198.   
  199.   F3    -   Toggles the printer On/Off.
  200.             Value is passed to PCBoard.
  201.   F4    -   Toggles the Page Bell On/Off.
  202.             Value is passed to PCBoard.
  203.   F5    -   DOS Shell.  Allows SysOp to exit to DOS from inside a DOOR.
  204.   F7    -   Toggles the Caller Alarm On/Off.
  205.             Value is passed to PCBoard.
  206.   F8    -   Returns the caller involuntarily to PCBoard.
  207.             Without letting them know that the sysop called them back!
  208.   F9    -   Toggles the local display On/Off.
  209.             Value is passed to PCBoard.
  210.   F10   -   Activates SysOp CHAT mode within the DOOR.
  211.  
  212.   ESC   -   Deactivates CHAT mode.  DOOR is resumed.
  213.   HOME  -   HELP key for status line options.
  214.   UP    -   Allows the SysOp to temporarily give the caller extra time
  215.             while in the DOOR.  This time is NOT passed to PCBoard.
  216.   DN    -   Allows the SysOp to temporarily subtract time from the
  217.             caller while in the DOOR.  This time is NOT passed to PCBoard.
  218.   ALT-N -   SysOp next on toggle.
  219.             Value is passed to PCBoard.
  220.   ALT-X -   PCBoard will exit after current caller logs off.
  221.             Value is passed to PCBoard.
  222.  
  223.                             WATCHDOG/CTTY/ANSI.SYS
  224.                             ----------------------
  225.  
  226.         CTTY and WATCHDOG are not required and should not be used with
  227.         this program.  CD Sub contains its own communication routines
  228.         which monitor the COM port.  If carrier is lost, it will return
  229.         to PCBoard where the BBS will log the user off the system.
  230.         ANSI.SYS, or something similar, is required for CD Sub to
  231.         function properly!
  232.  
  233.                                  DISTRIBUTION
  234.                                  ------------
  235.  
  236.         CD Sub is COPYRIGHTED by Richard Paquette, with all rights 
  237.         reserved. This program is being distributed via the SHAREWARE 
  238.         concept and as such, may be copied freely with the following 
  239.         restrictions:
  240.  
  241.                 * The program must be supplied in it's original
  242.                   unmodified form, including documentation.
  243.  
  244.                 * CD Sub may not be distributed as part of any
  245.                   commercial application or service without the
  246.                   express, written consent of the author.
  247.  
  248.                 * Vendors of Shareware/Public Domain software may
  249.                   not distribute this program without the express,
  250.                   written consent of the author.
  251.  
  252.                                  REGISTRATION
  253.                                  ------------
  254.  
  255.         CD Sub represents many hours of programming and the author
  256.         deserves just compensation for his time, efforts and expertise.
  257.         If you find this program to be of some value and you continue
  258.         to use it on your BBS system, you must return the registration
  259.         form provided along with the registration fee. Registration
  260.         entitles you to free upgrades from The Livewire BBS.
  261.  
  262.            **********           REGISTER ONLINE          ***********
  263.  
  264.         You may also call The Livewire BBS and register any of the
  265.         Livewire Doors online via Visa or Mastercard using our online
  266.         Credit Card door which will produce your registration number
  267.         on the spot! At the main board prompt just type  REGISTER  and 
  268.         presto your registration number is given to you.
  269.  
  270.         Suggestions and/or comments may be sent to the address below or
  271.         via electronic mail to: 
  272.    
  273.               The Livewire BBS 609-235-5297 Mt.Laurel, NJ 08054
  274.                               Richard Paquette
  275.  
  276.           RelayNet Node ID: LIVEWIRE or Inlelec Node ID is: LIVEWIRE
  277.            ILink Node ID: LIVEWIRE or SmartNet Node ID is: LIVEWIRE    
  278.            AfterDark Node ID: LIVEWIRE or FidoNet Address: 1:266/36
  279.  
  280.                             ----------------------
  281.